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1.0  INTRODUCTION 

Visualization  of  complex  information  is  one  of  the  best  ways  to  communicate  its  meaning.  The  focus  of  this  effort  is  on  the 
creation  of  the  appearance  portion  a  Virtual  Reality  Modeling  Language  (VRML)  file  that  is  used  to  visualize  ground 
vehicle  simulations.  As  Figure  1  depicts,  there  are  five  essential  elements  that  should  be  included  within  the  composite 
VRML  file  for  meaningful  visualization  effects.  Only  the  appearance  element  is  discussed  here. 


Figure  1  -  Essential  VRML  Visualization  Components 


The  appearance  element  is  a  generic  file  with  the  ".appearance"  extension  that  contains  color,  transparency,  and  texture 
information  for  each  geometry  part.  This  report  addresses  the  conversion  process  between  the  Geoclr  format  to  the 
generic  ".appearance"  format  to  be  used  with  VRML.  The  conversion  process  is  accomplished  with  the  AWK 
Programming  Language,  named  after  its  authors  (Alfred  V.  Aho,  Brian  W.  Kernighan,  and  Peter  J.  Weinberger  at  Bell 
Labs),  which  is  designed  to  provide  easy  data  manipulation  and  extraction  of  text  files.  In  this  case  the  Free  Software 
Foundation's  GNU  version,  GAWK,  is  used.  More  conversion  processes  may  be  developed  in  the  future  for  inclusion  of 
other  appearance  file  formats.  The  focus  of  this  discussion  is  restricted  to  the  conversion  of  the  Geoclr  format.  Section 
2.0  begins  with  a  discussion  of  the  Geoclr  format.  Section  3.0  discusses  the  appearance  (".appearance")  format,  section 
4.0  discusses  the  VRML  format  that  will  be  generated  from  the  ".appearance"  format,  and  section  5.0  outlines  the  GAWK 
conversion  processes  with  subsections  on  specific  topics. 
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2.0  GEOCLR  FORMAT 

The  Geoclr  or  ".geoclr"  file  format  was  developed  as  an  intermediate  file  format  to  better  associate  colors  with  each 
geometry  Movie. BYU  or  ".geo"  file  [1].  The  origin  of  this  format  is  based  off  of  the  DADS  Interactive  Visualizer  (DIVA)  [5] 
from  the  Army  High  Performance  Computing  Resource  Center  (AHPCRC).  DIVA'S  usage  of  geometry  and  colors  is 
based  on  ordered  lists  in  separate  files  (".list"  and  ".clr").  Each  geometry  file  (Movie. BYU)  is  associated  with  RGB  colors 
(values  0  to  255)  for  each  part.  For  better  organization,  a  separate  file  with  the  same  name  as  the  geometry  file  (".geo") 
was  created,  but  with  a  different  extension  (".geoclr"),  which  defines  the  color  for  each  part  for  that  geometry.  Changing 
colors  for  individual  parts  within  a  geometry  is  quicker  and  less  confusing. 

The  format  contains  two  sections.  Below  is  an  example  file  layout. 


. / geo/vicplsROT . geo 
10  100  20 
186  189  218 
30  30  30 
10  100  20 

The  first  line  specifies  the  geometry  file  name.  Each  following  line  specifies  the  RGB  color  for  each  part  in  the  geometry 
listed  in  the  first  line.  Note  the  RGB  values  are  in  the  zero  to  255  range  as  required  by  DIVA. 

3.0  APPEARANCE  FORMAT 

The  appearance  file  is  also  a  simple  ASCII  file  like  the  Geoclr  file,  only  with  a  different  format.  Its  format  is  laid  out  into 
sections  encapsulated  by  a  header  and  trailer  line.  Below  is  an  example  ".appearance"  file: 

#  . /geo/vicplsROTb . geoclr 

0.1  1  0.2  0  null 

1110  null 

0.3  0.3  0.3  0  null 

0.1  1  0.2  0  null 

#END 

The  header  line  begins  with  a  comment  "#"  and  ends  with  "#END".  Following  the  comment  character  the  name  of  the 
Geoclr  file  it  was  generated  from  should  be  given.  Each  line  between  the  header  and  trailer  contains  appearance 
information  for  each  part.  For  each  part  in  the  associated  Movie. BYU  geometry  file  the  RGB  color,  transparency,  and 
texture  file  name  is  specified.  Because  the  original  format  does  not  contain  transparency  or  texture  information  the 
defaults  of  "0"  and  "null"  are  automatically  inserted.  Note  the  value  range  for  RGB  colors  in  VRML  is  between  zero  and 
one,  not  zero  and  255.  Also,  the  transparency  value  ranges  between  zero  and  one  with  zero  being  opaque.  The  texture 
value  is  currently  a  place  holder  for  further  development  in  this  area  to  be  included  at  a  later  date. 

4.0  VRML  FORMAT 

The  appearance  data  used  in  the  VRML  file  [2]  is  included  using  the  Appearance,  Material,  ImageTexture,  and 
TextureTransform  nodes  as  defined  in  ISO  14772-1 :1997.  The  ImageTexture  and  TextureTransform  nodes  are  currently 
not  implemented  and  will  not  be  discussed  in  detail  here.  The  creation  of  these  nodes  is  done  during  final  scene 
assembly  with  another  program.  A  description  is  included  here  to  help  understand  where  the  appearance  data  is  included 
into  the  final  VRML  scene  file. 

The  Appearance  Node  template  is 

DEF  Ax_x  Appearance  {  material  ...  texture  ...  textureTransform  ...} }. 

This  node  defines  the  appearance  of  the  geometry.  By  including  a  name  to  the  node  definition,  it  can  be  referenced  later 
in  other  nodes  and  save  space  by  not  requiring  a  redefinition  of  all  the  coordinates.  However,  separate  color  definitions 
are  maintained  for  each  part  so  that  transparency  and  texture  features  will  be  unique  to  them. 

The  Material  Node  template  is 

Material  {  ambientintensity  ...  diffuseColor ...  emissiveColor  ...shininess  ...  specularColor ...  transparency  } 

Currently  only  the  following  properties  are  used 

Material  {  diffuseColor  ...  transparency  ...} 
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This  node  defines  all  the  color  and  transparency  values.  Each  part  will  have  an  Appearance  and  Material  node.  An 
example  section  of  a  VRML  (.wrl)  file  is  included  below: 

DEF  A9_l  Appearance  {  # . /testd/vicplsROTb . appearance 
material  Material  { 

dif fuseColor  0.100000  1.000000  0.200000 
transparency  0 . 0 

} 

}  # . /testd/vicplsROTb . appearance 

DEF  A9_2  Appearance  {  # . /testd/vicplsROTb . appearance 
material  Material  { 

dif fuseColor  1.000000  1.000000  1.000000 
transparency  0 . 0 

} 

}  # . /testd/vicplsROTb . appearance 

DEF  A9_3  Appearance  {  # . /testd/vicplsROTb . appearance 
material  Material  { 

dif fuseColor  0.300000  0.300000  0.300000 
transparency  0 . 0 

} 

}  # . / testd/ vicplsROTb . appearance 

DEF  A9_4  Appearance  {  #. /testd/vicplsROTb . appearance 
material  Material  { 

dif fuseColor  0.100000  1.000000  0.200000 
transparency  0 . 0 

} 

}  # .  /testd/vicplsROTb  .  appearance 

5.0  GAWK  CONVERSION 

The  creation  of  the  appearance  portion  of  the  VRML  file  is  done  with  GAWK.  This  is  a  very  useful  scripting  language  that 
is  available  for  UNIX  and  Windows  operating  systems  from  The  Free  Software  Foundation 
("www. gnu.org/software/gawk/gawk.html")  or  directly  from  Bell  Labs  ("cm.bell-labs.com/cm/cs/awkbook/").  Figure  2 
outlines  the  AWK  process. 


Figure  2  -  GAWK  process 


Parameters  are  passed  to  the  AWK  script  before  it  begins  processing  the  input  file.  Output  can  be  sent  to  the  standard 
output  or  a  specified  file.  An  example  of  the  calling  structure  with  the  script  name  "geo2appearance.awk"  is  given  below 

gawk  -v  SF=100.0  -v  SRC="./geo/"  -v  SUF=" . geoclr"  -v  DES=" . /testd/ "  -f  . . /src/geo2appearance . awk  geoclr. names 


5.1  INPUT 

The  input  file  is  named  "geoclr.names".  Its  contents  are  just  a  list  of  files  to  convert.  Its  format  contains  one  column.  The 
first  column  is  the  Geoclr  (or  ".geoclr")  file  name.  An  example  is  included  below: 


vicplsROTb 
axlelROTb 
axle2ROTb  1 
axle34ROTb 
axle5ROTb 
wheel IROTb  1 
ret drawbar 

trailerbitspreadwtank2 
RMS1. 50-ROT 
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5.2  PARAMETERS 

Table  1  defines  and  describes  the  parameters  passed  to  the  GAWK  script  for  processing  the  Geoclr  files. 
The  VRML  file  assumes  all  RGB  and  transparency  values  are  between  zero  and  one. 


Table  1  -  Parameter  Definitions 


VARIABLE 

DESCRIPTION 

EXAMPLE 

SF 

Scale  Factor.  Conversion  of  RGB  (0-255)  to 
RGB  (0-1).  (If  >  1,  set  to  1.) 

100.0 

SRC 

Source  Directory. 

"./geo/" 

SUF 

Geoclr  File  Suffix  Extension. 

BOH 

DES 

Destination  Directory. 

"./testd/" 

It  is  assumed  that  all  file  names  listed  in  the  "geoclr.names"  input  file  have  the  same  extension  (in  the  example  ".geoclr"). 
The  SF  scale  factor  can  be  used  to  "brighten"  colors  viewed  on  different  platforms  since  they  may  be  displayed  differently. 

5.3  OUTPUT 

The  converted  file  will  have  the  same  name  as  in  the  "geoclr.names"  file,  but  with  a  ".appearance"  extension.  This  format 
is  discussed  in  section  3.0. 

While  it  is  not  considered  directly  part  of  the  conversion  process,  output  of  a  formatted  version  of  the  "geoclr.names"  file  is 
required  for  scene  assembly  as  discussed  in  Section  1 .0  and  Figure  1 .  An  example  of  this  simple  AWK  program  is  given 
below 


gawk  '  {prirvtf  "%3d  %s\n",  NR,$1;}'  geoclr.names  >  A. names 

The  "A. names"  file  is  used  for  visual  inspection  of  the  appearance  index  number  to  ensure  proper  alignment  with  other 
VRML  properties  and  is  used  in  final  scene  assembly.  An  example  of  the  "A. names"  file  format  is  given  below. 

1  vicplsROTb 

2  axlelROTb 

3  axle2ROTb 

5  axle34ROTb 

6  axle5ROTb 

7  wheel IROTb 

8  ret drawbar 

9  trailerbitspreadwtank2 
10  RMS1.50-ROT 

5.4  CODE  SECTIONS 

The  GAWK  script  "geo2appearance.awk"  is  included  in  Appendix  A.  It  begins  with  checking  each  name  to  see  if  it  is  a 
duplicate.  If  it  is,  processing  skips  to  the  next  file  name.  Processing  for  each  file  name  is  continued  as  follows: 

1 .  Read  header  of  Geoclr  file  (Movie. BYU/". geo"  file  name) 

2  .  Read  in  RGB  color  for  each  part  (0-255) 

3.  If  RGB/SF  >  1 .0  then  set  RGB  value  to  SF. 

4.  Write  out  RGB  color  for  each  part  (scaled  by  SF)  with  default  transparency  ("0")  and  image  texture  ("null")  values. 

Note  that  setting  the  RGB/SF  value  to  the  SF  if  it  is  greater  than  one  will  result  in  the  final  RGB  value  of  one  when  it  is 
scaled  for  output  without  using  extra  storage  variables. 

6.0  SUMMARY/CONCLUSION 

A  simple  script  based  conversion  process  between  Geoclr  and  a  generic  ".appearance"  format  was  described  for  use  in 
scene  assembly  of  VRML  files.  It  should  be  noted  that  the  scene  assembly  portion  mentioned  in  section  1 .0  could  be 
done  with  X3D  [3].  Currently,  however,  many  advanced  utilities,  such  as  Cortona  Movie  Maker  [4]  will  only  work  with 
VRML  and  therefore  is  the  focus  at  this  time. 

CONTACT 

The  author  is  an  engineer  with  the  U.S.  Army  Research,  Development  and  Engineering  Command  (RDECOM),  located  at 
the  U.S.  Army  Tank-automotive  and  Armaments  Research,  Development  and  Engineering  Center  (TARDEC).  Interested 
parties  can  contact  the  author  at  the  U.S.  Army  Tank-automotive  and  Armaments  Research,  Development  and 
Engineering  Center  (TARDEC),  ATTN:  AMSRD-TAR-N/MS157,  6501  E  11  Mile  Rd.,  Warren,  Michigan  48397-5000, 
email:  “bylsmaw@tacom. army. mil". 
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DIVA  -  DADS  Interactive  Visualizer 


5 


APPENDIX  A  -  GE02APPEARANCE.AWK  SCRIPT 


# 

#geo2 appearance 

#  -v  SF=1 0  0 

#  -v  SRC="./geo/" 

#  -v  SUF=" . geoclr " 

#  -v  DES=" . /testd/ " 

# 

{ 

fi  =  SRC$ 1SUF ; 
if  (fi  in  names) 

{ 

print  "Duplicate" , fi; 

} 

else 

{ 

names [f i] =1 ; 

fo  =  DES$1 appearance" ; 
print  "Processing" , f i, , f o; 
printf  "#  %s\n",fi  >  fo; 
err=getline  <  fi; 

if  (err  <=0)  {print  " - error  reading" ,  fi;  exit;}; 

while  (getline  <  fi  >0) 

{ 

if  ($1/SF>1.0)  $ 1=SF ; 

if  ($2/SF>1.0)  $2=SF ; 

if  ($3/SF>1.0)  $3=SF; 

print  f o / $1/SF, $2/SF, $3/SF/ 0, "null" 

print  $1/SF, $2/SF/ $3/SF/ 0, "null"  »  fo; 

} 

printf  "#END\n"  »  fo; 
close (f i) ; 

} 
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APPENDIX  B-  RECOGNIZED  COLOR  KEYWORD  NAMES  FROM  SVG  1.1 

The  following  is  the  list  of  recognized  color  keywords  that  can  be  used  as  a  keyword  value  for  data  type  <color>  from  the 
SVG  1 .1  standard: 


aliceblue 
antique  white 
aqua 

aquamarine 
2]  azure 
n  beige 
bisque 
JH  black 

blanchedalmond 
^  blue 
_J  blueviolet 
|  brawn 
^  burlysvood 
^  csdetblue 
^  chartreuse 
~|  chocolate 
|  coral 


rgb(240,  248,  255) 
rgb(250,  235,  215) 
rgb(  0.  255,  255) 
rgb(127,  255,212) 
rgb(24G,  255,  255) 
rgb(245,  245,  220) 
rgb(255,  228,  196) 
rgb(  0.  0, 0) 
rgb(255,  235,  205) 
rgb(  0,  0, 255) 
rgb(13&,  43.  226) 
rgb(165, 42.42) 
rgb(222,  184,  185) 
rgb(  95,  158,  160) 
rgb(  1 27.  255,  0) 
rgb(21 0,  105,  30) 
rgb(255,  127,  80) 


_ |  lightpink 

rgb(255.  182,  193) 

_ |  lightsalmon 

rgb(255,  160,  122) 

_ |  lightseagreen 

ngb(  32.  178,  170) 

_ |  lightskyblue 

rgb(  1 35.  206,  250) 

_]  lightslategray 

rgb(1 19.  136,  153) 

_ |  lightslategray 

rgb(  1 1 9.  136,  153) 

_|  lightsteelblue 

rgb(176.  196,  222) 

_ |  lighty  allow 

rgb(255,  255.  224) 

_J  lime 

rgb(  0.  255,0) 

_ |  limegreen 

rgb(  50.  205, 50) 

|  linen 

rgb(250,  240,  230) 

^  m  agents 

rgb(255,  0,  255) 

|  m  a  roon 

rgb(126,  0,  0) 

^  m  ediumaquamarine  rgb(1G2.  205,  170) 
|  mediumblue  rgb(  0.  0,  205) 


mediumorchid 


rgb(1S6.  85.  211) 
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J  cornflowerblue 

rgb(10O,  149,  237) 

|  mediumpui  pie 

rgb(147,  112,219) 

2]  cornsilk 

rgb(255,  243.  220) 

|  rnedium&eagreen 

rgb(  60,  179,113) 

|  crimson 

rgb(220,  20,  60) 

|  mediumslateblue 

rgb(123.  104,  238) 

□  cyan 

rgb(  0,  255,  255) 

^  mediumspringgreen  rgb(  0,  250.  154) 

|  darkblue 

rgb(  0,  0.  139) 

|  mediumturquoise 

rgb(  72,209,  204) 

|  darkcyan 

rgb(  0,  139,  139) 

|  mediumvioletied 

rgb(199,  21,  133) 

~|  darkgol  denied 

rgb(184,  134, 11) 

|  midnightblue 

rgb(  25,25,  112) 

~|  darkgray 

rgb(169,  169,  169) 

|  mintcream 

rgb(245,  255,  250) 

^  darkgreen 

rgb(  0,  ICO,  0) 

niistyrose 

rgb(255,  228,  225) 

□  darkgrey 

rgb(169,  169,  169) 

|  moccasin 

rgb(255,  228,  181) 

^  darkkhaki 

rgb(1 89,  183,  107) 

|  navajowhite 

rgb(255,  222,  173) 

|  darkmagenta 

rgb(139,  0,  139) 

J  navy 

rgb(  0,  0,  128) 

|  darkolivegreen 

rgb(&5,  107,  47) 

|  ol  dlace 

rgt.(253,  245,  230) 

|  darkorange 

rgb(255,  1 40,  0) 

|  olive 

rgb(128,  128,  0) 

|  darkorchid 

rgb(153,  50,  204) 

J  olivedrab 

rgb(107.  142,  35) 

|  darkred 

rgbf  1 39,  0,  0) 

|  orange 

rgb(255,  165,  0) 

^  darksalmon 

rgb(233,  150,  122) 

|  or  angered 

rgb(255,  69,  0) 

^  darkseagreen 

rgb(143,  183,  143) 

~~]  orchid 

rgb(218,  1  12,  214) 

darkslateblue 

rgb(72,  61,  139) 

|  palegoldenrod 

rgb(238,  232,  170) 

|  darkslateg  ray 

rgb(  47,  79.  79) 

|  palegreen 

rgb(152,  251,  152) 

§  darkslateg rey 

rgb(  47,  79,  79) 

|  pale  turquoise 

rgb(175,  238,  238) 

darkturquoise 

rgb(  0,  2C6.  209) 

^  palevioletred 

rgb(219,  112,  147) 

|  darkviolet 

rgb(148,  0,  211) 

~|  papaya  whip 

rgb(255,  239,  213) 

|  deeppink 

rgb(255,  20.  147) 

|  peachpuff 

rgb(255,  218,  185) 

~~|  deepskyblue 

rgb(  0,  191,255) 

□  peru 

rgbi;205,  133,  63) 

~|  dimgray 

rgb(105,  105,  105) 

□*■* 

rgb(255,  192,  203) 

~|  diingrey 

rgb(105,  105,  105) 

|  plum 

rgb(221,  160,  221) 

dodgerblue 

rgb(  30,  144,  255) 

~|  powder  blue 

rgb(176,  224,  230) 

|  firebrick 

rgb(17B,  34,  34) 

|  purple 

rgb(128,  0, 128) 

floial  white 

rgbi'255,  250,  240) 

|  red 

rgb(255,  0.  0) 

|  forestgreen 

rgb(  34,  139,  34) 

~1  rosybrown 

rgb(188,  143,  143) 

|  fuchsia 

rgb(255,  0.  255) 

|  l  oyal  blue 

rgt.(  65.  105,  225) 

2]  gainsboro 

rgb(220,  220,  220) 

|  saddlebrown 

rgb( 1 39,  69.  19) 

_|  ghostw  hite 

rgb(243.  243,  255) 

B  salmon 

rgb(250,  128,  114) 

n  y°id 

rgbi'255,  215,  0) 

|  sandy  brown 

rgb(244,  164,  96) 

^  gpEdenrod 

rgb(213,  165,  32) 

seagreen 

rgb(  46,  139,  87) 

□  gray 

rgb(12S,  123,  128) 

|  seashell 

rgb(255,  245,  238) 

□  grey 

rgbi;i2S,  123,  128) 

J  sienna 

rgb(160,  &2,  45) 

|  green 

rgb(  0,  128,  0) 

|  silver 

rgb(192,  192,  192) 

greenyellcw 

rgb(173,  255,  47) 

□  skyblue 

rgb(1  35,  206.  235) 

honeydew 

rgb(240.  255,  240) 

|  slateblue 

rgb(106,  90,  205) 

f  hotpink 

rgb(255,  105,  130) 

J  slategray 

rgb(1 12,  128,  144) 

|  indianred 

rgb(205,  92,  92) 

|  slategrey 

rgb(1  12,  128,  144) 

|  indigo 

rgb(  75,  O,  130) 

|  snow 

rgb(255,  250,  250) 

ivory 

rgb(255,  255,  240) 

|  springgreen 

rgb(  0,  255,  127) 

|  |  khaki 

rgb(240,  230,  140) 

~~]  steel  blue 

rgb(  70 ,  130,  180) 

_|  lavender 

rgb(23Q,  230,  250) 

□  tan 

rgb(2 1 0,  180,  140) 

lavenderblush 

rgb(255,  240,  245) 

□  teal 

rgb(  0,  128,  128) 
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^  lawn  green 

rgb(124.  252,  0) 

|  lemonchiffon 

rgb(255.  250,  205) 

^  lightblue 

rgb(  1 73,  216,  220) 

lightcoral 

rgb(240.  12&,  128) 

1  lightcyan 

rgb(224,  255,  255) 

_ |  lightgoldenrcdyellow  rgb(250,  250,  210) 

□  lightgray 

rgb(211 . 21 1 ,  211) 

lighlgreen 

rgb(  1 44,  23&,  144) 

lightgrey 

rgb(211 , 211,21 1) 

thistle 

rgb(216,  191,  216) 

J  tomato 

rgb(255,  99,  71) 

^  turquoise 

rgb(  64.  224,  20&) 

|  violet 

rgb(238,  130,  238) 

^  wheat 

rgb(245,  222.  179) 

|  |  white 

rgb(255,  255,  255) 

^  whitesmoke 

rgb(245,  245,  245) 

^  yellow 

rgb(255,  255,  0) 

^  yellow  g  reeii 

rgb(154,  205,  50) 
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